home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / util / cli / JazTools.readme < prev    next >
Encoding:
Text File  |  1999-09-06  |  12.0 KB  |  308 lines
  1. Short:    Iomega JAZ tools
  2. Author:   thor@math.tu-berlin.de (Thomas Richter)
  3. Uploader: thor@math.tu-berlin.de (Thomas Richter)
  4. Version:  0.16
  5. Type:     util/cli
  6. Requires: Os 2.04, A jaz drive (guess what...)
  7.  
  8.  
  9. This program provides functions available thru the Iomega "JazTools" on
  10. Mac and PC, like setting the spindown delay, ejection of cartridges and
  11. more. Unlike the ZJTools, this program really works within its 
  12. specifications... (-:
  13. _____________________________________________________________________________
  14.  
  15. This is a beta release. Actually, everything works as it should, and every-
  16. thing has been tested, but the program is still somewhat incomplete. Since
  17. I do not own a JAZ drive, I need your help!
  18.  
  19. What's to be done:    Actually, only one thing, namely the DISKSTATUS
  20.             option. It does already work, but not in the ideal
  21.             way. It takes just too long to obtain the status, as
  22.             there is an Iomega specific command to do the same
  23.             much faster. I do not yet know how to use it, though.
  24.  
  25. How to help me:        I need detailed information about "rather bad" JAZ
  26.             media whose life time is below 99%, as printed by
  27.             the original Mac JAZTools. Furthermore, SCSIQuery
  28.             is required, and a Mac emulator, like ShapeShifter,
  29.             to run the original JAZTools.
  30.             You find this program either on my home page, or in 
  31.             the Aminet. Then, please do the following:
  32.  
  33. Load the Mac emulator and the original JazTools. Check the disk life time
  34. remaing, using the original Iomega provided tool. To help me, this should be
  35. 98% or worse. Please write down the numbers, both, the life time remaining
  36. and the current disk state. Afterwards, please use the SCSIQuery command on
  37. the same media, and please sent me its printout, and the two numbers read
  38. from the original tool. This might help me to test where this information is
  39. kept. Thanks a lot!
  40. _____________________________________________________________________________
  41.  
  42. Announcement:    JAZ drivers for the Amiga.
  43.  
  44. If there is enough interest, I will write a more complete JAZTools program
  45. than this, including a disk driver, a small JAZ-optimized disk cache, im-
  46. plementing JAZ specific functions more JAZ-compliant than this product.
  47. More specifically, the "write verify" will be implemented correctly, the
  48. spindown timer will work correctly, and you'll see a graphical user inter-
  49. face for a collection of JAZ tools. The problem with this stand-alone tool
  50. is, that due to how the JAZ works, not all functions are really available.
  51. The SCSI interface is a bit different than that for usual devices.
  52.  
  53. The price for the product would range from $20 to $30.
  54.  
  55. If you're interested in such a tool and would buy it, please let me know.
  56. If there is enough interest, I'll start the work. PLEASE DO NOT YET send
  57. money.
  58. _____________________________________________________________________________
  59.  
  60. Synopsis:
  61. JazTools    HANDLER=DEVICE/A,UNIT/K/N,FLAGS/K/N
  62.         SPINDOWN/K/N,PRINTSPINDOWN/S,
  63.         DISKID/S,DISKSTATUS/S,DRIVEID/S,PRINTPROTECT/S,
  64.         EJECT/S,START/S,
  65.         VERIFY/K,PASSWORD/K,
  66.         WPROTECT/S,RWPROTECT/S,
  67.         UNPROTECT/S,TEMPUNPROTECT/S,
  68.         IOEXTEND/K,
  69.         EJECTDELAY/K/N,STARTDELAY/K/N,
  70.         FLUSHDELAY/K/N,INHIBITDELAY/K/N,
  71.         QUIET/S
  72.  
  73.  
  74. HANDLER=DEVICE/A:    Either the name of the AmigaDos device like JAZ: or
  75.             JH0: the Jaz is mounted as, with a colon at the end.
  76.             Alternatively, the name of the exec device driver
  77.             if the drive is not mounted, like "scsi.device",
  78.             "oktagon.device" or "gvpscsi.device".
  79.             If you specify the drive by its exec device driver,
  80.             you MUST give a unit as well, and the JazTools will
  81.             not check whether the device is mounted and available.
  82.  
  83. UNIT/K/N:        If the JAZ was specified by its exec device driver,
  84.             this is the SCSI Unit ID of the Jaz. 
  85.             This information is not required if you specified
  86.             the drive by its AmigaDos device name.
  87.  
  88. FLAGS/K/N:        A flags value for opening the exec device driver, 
  89.             only looked at if the JAZ was specified by its exec
  90.             driver name and ignored otherwise. This defaults to
  91.             0, and is usually not required at all. Some device
  92.             drivers check the SCSI bus again if the flags value
  93.             is set to 1 and hence might be able to detect a
  94.             JAZ which was powered on later. 
  95.  
  96. SPINDOWN/K/N:        Sets the spin-down delay for the specified unit, in
  97.             minutes. Valid numbers range from 1 to 60 minutes.
  98.             The JAZ calculates the spindown time by counting the
  99.             TEST_UNIT_READY commands, expecting one every second.
  100.             Unfortunately, the Amiga sends them more often making
  101.             a JAZ-minute approximately 50 seconds long.
  102.  
  103.             If the argument is 0, the current spindown setting
  104.             is printed.
  105.  
  106.             *This command depends on device driver internals,
  107.              the spindown time will not be set 100% correctly,
  108.                or might fail to be set at all. A true JAZ device
  109.              driver will make this working*
  110.  
  111. PRINTSPINDOWN/S:    Prints the spindown time in minutes.
  112.  
  113.  
  114. DISKID/S:        Prints unique cartridge ID. I don't know what
  115.             this could be used for.
  116.  
  117. DISKSTATUS/S:        Prints the disk life remaining, estimated by the
  118.             number of bad blocks the JazTools program finds
  119.             on the cartrigde, and the current disk status.
  120.             The first number is the amount of permanent bad
  121.             blocks, the second number is the amount of bad
  122.             blocks that could be recovered by re-formatting
  123.             the cartridge.
  124.  
  125.             *This command does not yet use the Iomega specific
  126.              commands to read the diskstatus. It might take
  127.              approximately 15min to get the information. 
  128.              I need your help to implement this correctly, see
  129.              the introduction*
  130.  
  131. DRIVEID/S:        Prints the INQUIRY information of the drive, like
  132.             the vendor and version information.
  133.  
  134. PRINTPROTECT/S:        Prints the protection status of the cartridge.
  135.  
  136. EJECT/S:        Ejects the cartridge. If the drive was specified
  137.             by its AmigaDos device name, the JazTools check
  138.             whether the device is available to AmigaDos and
  139.             fail in case it's not. Hence, if you want to
  140.             eject an unmounted cartdrige, specifiy the JAZ by
  141.             its exec device name and its SCSI ID.
  142.  
  143. START/S:        Restarts the drive in case it was parked, either
  144.             automatic or manually.
  145.  
  146. VERIFY/K:        Takes an argument, either "on" or "off". This 
  147.             *might* enable the automatic verify, at least
  148.             partially.
  149.  
  150.             *This command is not implemented 100% correctly,
  151.              it enables a verify bit in the JAZ, but does not
  152.              enforce the use of the correct write command.
  153.              Therefore, the drive might not verify as expected,
  154.              or might even do worse. A true write verify function
  155.              can't be implemented without a JAZ specific device
  156.              driver, which would adjust the write command sent
  157.              to the device according to the verify status.
  158.              Moreover, a final edition might implement a software
  159.              verify bit which might mean less stress for the
  160.              medium*
  161.  
  162. PASSWORD/K:        This option provides a password, required for various
  163.             suboptions below.
  164.  
  165. WPROTECT/S:        Write-protect a medium. A password is optional.
  166.             If a password is given, the same password is 
  167.             required to unlock the medium again.
  168.  
  169. RWPROTECT/S:        Lock a medium for reading and writing. The password
  170.             is mandatory, i.e. it won't work without. 
  171.  
  172. UNPROTECT/S:        Unprotect a medium, remove the read or write 
  173.             protection. A password may or may not be required,
  174.             this depends on whether a password was given when
  175.             the volume was locked.
  176.  
  177. TEMPUNPROTECT/S:    Unprotect a medium temporarely, it will get locked
  178.             again as soon as it is removed again. Except for
  179.             that, this option is identically to UNPROTECT.
  180.  
  181. IOEXTEND/K:        Enables or disables Iomega specific functions of
  182.             the drive I've no great idea about. The argument
  183.             should be either "on" to enable them or "off" for
  184.             disabling them.
  185.  
  186.             *Currently, this shouldn't really make a difference*
  187.  
  188. EJECTDELAY/K/N:        A delay in fifties of a second ("Ticks") before the
  189.             JAZ is made available to the filing system again 
  190.             after ejection, required for the JAZ to settle down.
  191.             Defaults to 50, i.e. one second.
  192.  
  193. STARTDELAY/K/N:        Currently not yet used.
  194.  
  195. FLUSHDELAY/K/N:        A delay in fifties of a second to allow the filing
  196.             system to swap out its buffers before ejecting the
  197.             device. This is an ugly and uneffective workaround
  198.             against a bug in the FFS. (ACTION_FLUSH is not 
  199.             implemented correctly)
  200.             Defaults to 150, i.e. 3 seconds.
  201.  
  202. INHIBITDELAY/K/N:    A delay in fifties of a second after locking the
  203.             device from the filing system and before allowing
  204.             other operations, required for the filing system to
  205.             settle down.
  206.             Defaults to 100, i.e. 2 seconds.
  207.  
  208. QUIET/S:        Disables printing the copyright message.
  209. _____________________________________________________________________________
  210.  
  211. Credits:
  212.  
  213. Thanks to Werner Müller and Georges Heinesch for testing this program and
  214. for providing the necessary information by running a lot of tests.
  215. _____________________________________________________________________________
  216.  
  217.                          The THOR-Software Licence (v2, 24th June 1998)
  218.  
  219.  
  220. This License applies to the computer programs known as "JazTools". The 
  221. "Program", below, refers to such program. The "Archive" refers to the 
  222. package of distribution, as prepared by the author of the Program, 
  223. Thomas Richter. Each licensee is addressed as "you".
  224.  
  225.  
  226.  
  227. The Program and the data in the archive are freely distributable
  228. under the restrictions stated below, but are also Copyright (c)
  229. Thomas Richter.
  230.  
  231. Distribution of the Program, the Archive and the data in the Archive by a
  232. commercial organization without written permission from the author to any
  233. third party is prohibited if any payment is made in connection with such
  234. distribution, whether directly (as in payment for a copy of the Program) or
  235. indirectly (as in payment for some service related to the Program, or
  236. payment for some product or service that includes a copy of the Program
  237. "without charge"; these are only examples, and not an exhaustive enumeration
  238. of prohibited activities).
  239.  
  240.  
  241. However, the following methods of distribution
  242. involving payment shall not in and of themselves be a violation of this
  243. restriction:
  244.  
  245.  
  246. (i) Posting the Program on a public access information storage and
  247. retrieval service for which a fee is received for retrieving information
  248. (such as an on-line service), provided that the fee is not
  249. content-dependent (i.e., the fee would be the same for retrieving the same
  250. volume of information consisting of random data).
  251.  
  252.  
  253. (ii) Distributing the Program on a CD-ROM, provided that
  254.  
  255. a) the Archive is reproduced entirely and verbatim on such CD-ROM, including
  256. especially this licence agreement;
  257.  
  258. b) the CD-ROM is made available to the public for a nominal fee only,
  259.  
  260. c) a copy of the CD is made available to the author for free except for
  261. shipment costs, and
  262.  
  263. d) provided further that all information on such CD-ROM is redistributable
  264. for non-commercial purposes without charge.
  265.  
  266.  
  267. Redistribution of a modified version of the Archive, the Program or the
  268. contents of the Archive is prohibited in any way, by any organization,
  269. regardless whether commercial or non-commercial. Everything must be kept
  270. together, in original and unmodified form.
  271.  
  272.  
  273.  
  274.  
  275. Limitations.
  276.  
  277.  
  278. THE PROGRAM IS PROVIDED TO YOU "AS IS", WITHOUT WARRANTY. THERE IS NO
  279. WARRANTY FOR THE PROGRAM, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT
  280. LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A
  281. PARTICULAR PURPOSE AND NONINFRINGEMENT OF THIRD PARTY RIGHTS. THE ENTIRE
  282. RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD
  283. THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY
  284. SERVICING, REPAIR OR CORRECTION.
  285.  
  286.  
  287. IF YOU DO NOT ACCEPT THIS LICENCE, YOU MUST DELETE THE PROGRAM, THE ARCHIVE
  288. AND ALL DATA OF THIS ARCHIVE FROM YOUR STORAGE SYSTEM. YOU ACCEPT THIS
  289. LICENCE BY USING OR REDISTRIBUTING THE PROGRAM.
  290.  
  291.  
  292.                                                         Thomas Richter
  293.  
  294. _____________________________________________________________________________
  295.  
  296. Thomas,        
  297.     April 1999
  298.  
  299.  
  300. ============================= Archive contents =============================
  301.  
  302. Original  Packed Ratio    Date     Time    Name
  303. -------- ------- ----- --------- --------  -------------
  304.    17448    9680 44.5% 24-Apr-99 12:50:20 +JazTools
  305.    11879    4888 58.8% 10-Jul-99 13:55:34 +JazTools.readme
  306. -------- ------- ----- --------- --------
  307.    29327   14568 50.3% 13-Jul-99 03:51:20   2 files
  308.